home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 2 / Gold Medal Software Volume 2 (Gold Medal) (1994).iso / database / bibl849a.arj / BIBLSW.INS / BIBL.DOC next >
Text File  |  1993-10-06  |  66KB  |  1,734 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. BIBL
  8. ■══════════════════════════════════════
  9.  
  10. release 8.4x
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.         (c) 1991-93, GMUtant Software
  40.  
  41.          Clyde W. Grotophorst
  42.          Route 1, Box 296
  43.          Hamilton, Virginia 22068
  44.          U.S.A.
  45.  
  46.  
  47. This documentation covers both the SHAREWARE and REGISTERED
  48. versions of the package. Non-registered users of this software are
  49. granted a limited license to make an evaluation copy for trial use
  50. on a private, non-commercial basis, for the express purpose of
  51. determining whether BIBL meets their needs. At the end of this
  52. trial period, (30 days) you should either register your copy or
  53. discontinue use. 
  54.  
  55. Registration licenses you to use the product on a regular basis.
  56. Registration also provides you with access to the GMUtant Online
  57. BBS ((703) 993-2219) as a registered user--where you may receive
  58. support, leave questions, requests for enhancements, or download
  59. the latest release of the program. The registered version offers
  60. expanded capabilities.
  61.  
  62. Registering BIBL will also allow you to download special programs
  63. from the GMUtant OnLine BBS--for example, BIBL286 is a version of
  64. BIBL using machine code for the 80286 or 80386 processor. This
  65. allows BIBL to take better advantage of these CPUs and creates a
  66. slightly smaller BIBL.EXE file. BIBLPCX enables you to seamlessly
  67. view a PCX image file that is linked to a BIBL records. 
  68.  
  69. The registration fee for BIBL is $ 39.00. Once you have registered,
  70. you will be given a registration number. You may 'upgrade' your
  71. SHAREWARE version to REGISTERED by entering that number into BIBL
  72. (via CONVERT on the maintenance menu). By using this method, you
  73. may instantly upgrade any subsequent release without having to call
  74. our BBS to download the file.
  75.  
  76. If you have registered a previous version of BIBL, you are also a
  77. registered user of any subsequent version. You may upgrade at any
  78. time by sending $ 10.00 to the address below. The latest version
  79. will be sent by return 1st Class mail (specify disk size).
  80.  
  81. Send your name, address and registration payment to:
  82.  
  83. Clyde W. Grotophorst
  84. Route 1, Box 296
  85. Hamilton, VA 22068 USA
  86.  
  87.  
  88. CREDIT CARD ORDERS
  89.  
  90. You may also order the registered version of BIBL from Public
  91. (software) Library with your MasterCard, Visa, American Express, or
  92. Discover Card by calling 800-2424-PSL or 713-524-6394 or by FAX to
  93. 713-524-6398, or by CompuServe to 71355,470 or by mail to PsL, P.O.
  94. Box 35705, Houston, Texas 77235-5705. These numbers are for
  95. ordering only. The cost is $ 39.00 which includes a copy of the
  96. latest registered version to you by return 1st class mail.
  97. We've included sample records with BIBL for
  98. demonstration purposes--a database named DEMO
  99. (DEMO.DAT and DEMO.IX). Type BIBLDEMO at the
  100. DOS prompt to extract these files. You may delete
  101. DEMO.DAT and DEMO.IX when you are ready to begin
  102. entering information you want to keep. To see the sorts of
  103. things included in the sample file, and to study how you
  104. might use the fields in a BIBL record, activate BIBL then
  105. press L, the last record in the file will display. Press [B] to
  106. move backward through the file.
  107.  
  108. BIBL Features [SHAREWARE and REGISTERED]:
  109.  
  110. - an unlimited number of databases are supported.
  111. - move records from one database to another
  112. - menu-driven.
  113. - mouse-support for most areas of the program.
  114. - easily understood user interface 
  115. - five indexes are maintained (in a single file) for fast
  116.   retrieval and sorted extracts (author, author/title, title,
  117.   subject, and keyword)
  118. - up to 9 keywords for each record are indexed.
  119. - produces bibliographies in several forms (brief, 
  120.   annotated, full (and with registered version, a new database)
  121.   based on information in any field. Each bibliography is sorted by
  122.   author, then within author, by title. Registered version also
  123.   supports searching *anywhere* in a record for matches.
  124. - user-selected fields for output (soft return option
  125.   available).
  126. - link text files to records in your database...then view
  127.   them with a single keystroke.
  128. - when no match is made on an indexed search, BIBL
  129.   displays where in the index your query would have
  130.   appeared (near misses).
  131. - produces a wide variety of lists (in ASCII form) which
  132.   may be printed or edited with any word processor that
  133.   accepts ASCII files for input.
  134. - use WordPerfect or other large program as your external
  135.   editor/viewer/printing program. BIBL's memory
  136.   management routines to enable even WordPerfect to run as
  137.   a 'child' process.
  138. - if desired, BIBL will run in a 'read-only' mode. This
  139.   allows copies of your database to be accessed by the public
  140.   but protects against editing, deleting or otherwise
  141.   modifying the file.
  142. - BIBL supports cloning of records during data entry 
  143.   (carry forward).
  144. - BIBL offers a built-in ASCII file viewer that supports a
  145.   mouse and can view files of any size.
  146. - Index progress graph displays during reindexing.
  147. - ability to print or save to disk any record.
  148. - main menu screen always reports active database and
  149.   number of records in that file.
  150. - verification of subject and keywords during data entry (if
  151.   desired)
  152. - BIBL shells out to PKZIP, LHA or ARJ to create
  153.   compressed backup copies of your database. BIBL will find
  154.   the compression utility if it exists ANYWHERE on your
  155.   DOS path.
  156. - Boolean AND, OR, NOT searching supported for ALL
  157.   fields. Up to four terms may be used. May also limit
  158.   search to descriptor field.
  159. - Selected reports (list of subjects, list of titles, etc.) may
  160.   be viewed onscreen and/or sent to disk.
  161. - BIBL can export a comma-delimited verison of data.
  162. - any ASCII file may be used for display when I (INFORMATION)
  163.   is pressed on the main menu.
  164. - Shell to DOS with heap compression.
  165.  
  166. REGISTERED version adds these features:
  167.  
  168. BIBL will store index data in EMS (Expanded Memory) if
  169. it is available on your system...otherwise, a 40% of
  170. available RAM (after BIBL loads) is devoted to in-memory
  171. index storage. BIBL will allocate up to 33% of available
  172. EMS to index storage. EMS speeds retrieval and cut
  173. reindexing time for larger databases. In tests on systems
  174. without disk caching, we found an average improvement of
  175. 33%.
  176.  
  177. Support for PCX image files included. You can use a PCX
  178. file as your linked file and BIBL will display it using the
  179. utility BIBLPCX.EXE - included on the registered version
  180. distribution diskette.  You can use other IMAGE formats,
  181. if you provide the viewing program.
  182.  
  183. Using the "DATABASE" output option under BIBLIOGRAPHIES,
  184. you may create a new database of records that matched your query.
  185. When this new (automatically indexed) database is selected, you
  186. can gain the formatting power of the USER-SELECTS option under
  187. the Export menu. If desired, you can have BIBL delete the records
  188. from the original database as they are copied.
  189.  
  190. Bibliographies (option D under EXPORT) as well as other
  191. reports may be created in 'word-processing' form (this will
  192. put soft returns in your file within a given citation, hard
  193. returns between them). Makes it much easier to edit the file
  194. with a word processor.
  195. Rename Author, Title, Publisher, Keyword, Location and
  196. Subject fields to any name you choose for individual
  197. databases. BIBL will refer to these new field names
  198. throughout the program. You may also change ANY field's
  199. label on the display, add and/or edit screens.
  200.  
  201. Bibliographies. Registered version supports export of
  202. records based on ANY field in the record, not just Author,
  203. Publisher, Subject, or Descriptor. Even *anywhere* in the
  204. record.
  205.  
  206. Produce list of titles sorted by keyword.
  207.  
  208. When running a BOOLEAN search, you may send matching records to
  209. disk if desired. BIBL offers two formats for output
  210. (BIX or unlabelled). Selecting BIX format enables you to
  211. move the matching data to another BIBL database.
  212.  
  213. Store Datafiles and Indexes (*.DAT and *.IX) on another
  214. drive or in another subdirectory. This enables you to use
  215. BIBL on remote disks if desired (e.g., on a LAN).
  216.  
  217. Global Find & Replace for text in ANY field, across the
  218. database.
  219.                I N S T A L L A T I O N
  220.  
  221. Place diskette in drive (or copy contents to a subdirectory
  222. on a hard disk) and type INSTALL. Make sure your
  223. CONFIG.SYS file has the following minimum values:
  224.           
  225.          FILES=25
  226.          BUFFERS=15
  227.  
  228. To find out whether your machine has a CONFIG.SYS
  229. file, issue the following commands:
  230.  
  231. PROMPT $P$G [press return]. You may already be using
  232. this prompt string, but if not, at least from here on out you
  233. will know what drive and directory you are defaulting to.
  234.  
  235. C: [press return...we want to log onto the C: drive]
  236.  
  237. CD\ [press return], this should put us in the root directory
  238. a 'C:\>' prompt should appear. If so, type the following
  239. command:
  240.  
  241. DIR C*.SYS [press return]
  242.  
  243. If you do not see a file named CONFIG.SYS in the newly
  244. displayed text, you can safely assume that one does not
  245. exist. 
  246.  
  247. To Create CONFIG.SYS: Issue the following commands at
  248. C:\> prompt (to be a bit more technical, while logged
  249. onto the root directory
  250. of the boot drive (typically C:) of your system):
  251.  
  252. Copy Con: CONFIG.SYS [press return]
  253. FILES=25   [press return]
  254. BUFFERS=20 [press F6]
  255.  
  256. You should receive a '1 file copied.' message. Reboot your
  257. computer. The CONFIG.SYS file is read only during initial
  258. boot of your system. Questions? Check your DOS manual.
  259.  
  260. S Y S T E M    O V E R V I E W 
  261.  
  262. BIBL (rhymes with nibble) is a simple to use online
  263. catalog for your personal library. Written in Pascal
  264. and assembler BIBL is fast, and efficient.
  265. Menu-driven, BIBL can be used to track your book
  266. collection, article reprints, index your vertical file,
  267. manage a small office library, and so on... 
  268.  
  269. In most areas bounce-bar menus are used. To select
  270. a particular option, move the bar via the cursor until
  271. your desired operation is highlighted, then press
  272. RETURN. If you're a touch typist, you might prefer
  273. pressing the highlighted letter within (or just to the
  274. left of) the choice you wish to make (e.g., Press S to
  275. activate SEARCH on the main menu). On single line
  276. menus (e.g., when displaying matches), you may hit
  277. the highlighted letter to execute the command, or
  278. move between them via the TAB key. Clicking a
  279. mouse on your menu choice will also activate it.
  280.  
  281. Command Line Switches (Name  /p /m /v /d)
  282.  
  283. [/d] Database selection. Put the name (DAT extension
  284. unnecessary) of the database you want to use on the
  285. command line if desired. This will bypass the
  286. selection menu if you have more than one database
  287. (*.DAT and *.IX file combination) in the same
  288. subdirectory. For example: BIBL DEMO /m
  289. [RETURN] at the DOS prompt would activate BIBL
  290. in monochrome mode and open the database named
  291. DEMO.
  292.  
  293. [/m] Monochrome operation. BIBL attempts to
  294. identify your display hardware...switching to color or
  295. monochrome color schemes as required. If you find
  296. the program is difficult to use on your hardware, try
  297. forcing a monochrome display with the /m command
  298. line argument (e.g., BIBL /m [return].
  299.  
  300. [/p] OPAC (Online Public Access Catalog) operation.
  301. If you want to have others use your BIBL database
  302. but don't want them adding, deleting, or editing
  303. records, begin BIBL with the /p switch. This
  304. activates OPAC mode, disabling the Add function
  305. and Maintenance Menu.  [Registered version also
  306. supports setting this value via the OPAC=True
  307. statement in BIBL.INI]
  308.  
  309. [/v] 43/50 lines. REGISTERED ONLY. Use this
  310. switch if you run BIBL under DesqView...it will
  311. force BIBL into a 43 or 50 line display mode (great
  312. for putting in a small window).
  313.  
  314. You may use any combination of command line
  315. arguments, in any order--with the exception that
  316. FILENAME if it appears must be the first one.
  317. When you type BIBL at the DOS prompt, several
  318. things happen...
  319.  
  320. 1) the program checks to see if it is running under
  321. Windows 3.x. If so, then the SAVE function is
  322. converted to the CLIP function and the system
  323. initialization message changes from "Initializing..."
  324. to "Initializing with Windows Clipboard support...".
  325.  
  326. 2) Memory is allocated for storage of index buffers.
  327. The SHAREWARE version sets aside 20K, the
  328. REGISTERED version uses either 2K conventional
  329. memory and up to 300K of EMS or up to 40% of
  330. available RAM).  Clearly, the registered version
  331. running on a machine with EMS memory available
  332. yields the fastest operation (since for many
  333. databases, the entire index is loaded into memory).
  334.  
  335. 3) if you are using the SHAREWARE version, a
  336. reminder to register screen appears (actually appears
  337. about 50% of the time).
  338.  
  339. 4) the program next checks your disk to see how
  340. many *.DAT files can be found...
  341.  
  342. a) One, BIBL opens that database.
  343. b) More than one, a pick-list appears. Select the file 
  344. you want to use by moving the light bar with the
  345. cursor arrows until desired file is highlighted--then
  346. press RETURN (or double-click mouse on desired
  347. file).
  348.  
  349. 4) the main menu appears.
  350.  
  351.                   Main Menu Options
  352.  
  353. L    List items in the database. This option allows
  354. you to move through the database a record at a time.
  355. The records appear in the order in which they were
  356. entered into the system. Pressing L on the main menu
  357. takes you to the last record in the file (the assumption
  358. being that you are probably more interested in the
  359. more recent records). You may move about the file
  360. via the J (Jump) command--which 'jumps' you to the
  361. record number you enter.
  362.  
  363. A        Add an item to the file. Use for entering
  364.          data into a database. Is disabled with /p (OPAC)
  365.          switch at startup.
  366. S        Search a database. Supports a variety of
  367.          searches.
  368. E        Export data. Enables user to produce a
  369.          variety of reports, including bibliographies.
  370. V        View ASCII file(s). Allows user to look at
  371.          an ASCII file. If you have installed a word
  372.          processing program as your external viewer, then that
  373.          program is used for viewing, otherwise, BIBL uses a
  374.          built-in file browsing function. BIBL's built-in viewer
  375.          can browse files of any size.
  376. M        Maintenance functions. This function
  377.          provides a variety of support operations (rebuilding
  378.          indexes, creating new databases, deleting databases,
  379.          Shell to DOS, backup, etc.). Disabled if OPAC=true
  380.          statement appears in BIBL.INI or if the /p (read-only)
  381.          switch is used at startup (e.g., BIBL /p [return]).
  382. D        Database selection. Once you have created a
  383.          second database, this function allows you to move
  384.          between database files.
  385. I        Information on BIBL. Pressing I on the Main
  386.          Menu causes the file BIBL.HLP to display in a
  387.          window on your screen. To create your own help
  388.          file, make an ASCII file and name it BIBL.HLP.
  389.          You do not have to worry about page breaks or other
  390.          formatting.
  391. Q        Quit to DOS. Closes all files, halts program
  392.          and exits.
  393.  
  394. DATABASES
  395.  
  396. BIBL can manage an unlimited number of databases
  397. (any combination of a *.DAT and *.IX file is
  398. considered a database). While the structure of each
  399. database is the same, you may have several--enabling
  400. you to separate out records that belong together. You
  401. can create new databases from the Maintenance
  402. menu. Once created, you may select (that is, make it
  403. the active database) a particular database via the
  404. Database Selection option on the main menu.  The
  405. entire program operates on only 1 active database at
  406. a time.
  407.  
  408. I. ADDING RECORDS TO A DATABASE
  409.  
  410. Each database is limited to 5 million records although
  411. you'll run out of disk space long before that becomes
  412. an issue. To begin working toward that 5 million,
  413. press A as the main menu displays.
  414.  
  415. A blank record appears on the screen. Enter data in
  416. the highlighted fields. If you want to skip a field, just
  417. press RETURN when the cursor is inside that field's
  418. highlighted box. If you are using a mouse, you may
  419. click on the field you want to edit. If text is already
  420. in a field, clicking on a particular position in the field
  421. moves the cursor to that point.  Several command
  422. keys are active during the ADD function:
  423.  
  424. F1       Help
  425. ALT-V    Checks Subject and Keywords you have
  426. entered against those already in the database.  This
  427. helps maintain a controlled vocabulary of keywords.
  428. ESC      Done.
  429.  
  430. To add a note (up to 700 characters), hit return when
  431. the cursor is on the note symbol (or click it). A
  432. text-editor pops up allowing you to write your
  433. note...when finished, press ESC. To finish adding to
  434. the record, press ESC again.
  435.  
  436. BIBL will then offer a prompt line at the bottom of
  437. the screen, asking to file the record. If you answer
  438. yes, you'll then receive a prompt asking if you want
  439. to add another record.
  440.  
  441. Press "Y" to add another record.
  442.  
  443. Press "C" to clone the record you're looking at.
  444. BIBL will copy all information from this record to a
  445. new one, then position the cursor in the first field of
  446. the new record.  Edit this as necessary.
  447.  
  448. Press "N" to abandon the data entry function.
  449.  
  450. BIBL INDEXING
  451.  
  452. Four indexes are maintained in the single file: 1) the
  453. first 15 characters of the author field, 15 characters
  454. of the TITLE field, each word (something with a
  455. space before and after it) of the keyword field (must
  456. be more than a single character), and a fourth index
  457. used to create temporary sorts (by call number,
  458. author/title, etc.). By putting all four indexes in a
  459. single file, performance is improved over systems
  460. that put each index in its own file--DOS does not
  461. need to allocate a large number of file handles for
  462. BIBL's use.
  463.  
  464. Information is stored in upper case in the index file
  465. and your query is converted to upper case before a
  466. search begins--thus you don't have to worry about
  467. capitalization (although the way you enter data is the
  468. way it will display and appear in any ASCII file
  469. created by BIBL.
  470.  
  471. FIELDS (Subject vs Keyword) Most fields are
  472. obvious, but you might not be familiar with the
  473. distinction we're making between subject and
  474. keyword. Remember that the Keyword field is
  475. indexed while the subject is not...as your database
  476. grows, retrieval via keyword will always be faster
  477. than retrieval by subject. If you have a term that
  478. requires more than 20 characters to describe (the
  479. limit for a single keyword entry) then place that term
  480. in the subject field.
  481.  
  482. EVERY word (anything between spaces) in the
  483. keyword field is individually indexed.
  484.  
  485. Caution: No term in the keyword field can be longer
  486. than 20 characters (or it will be truncated to 20
  487. characters in the index). The indexing algorithm
  488. considers a word to be anything between two blank
  489. spaces. If you have a compound term, include a '-'
  490. between the words so they'll be considered a single
  491. term (e.g., 'World-War-II' is considered 1 term
  492. while 'World War II' is three.). Up to 9 words in
  493. any one Keys: field will be indexed. A single letter
  494. WILL NOT be indexed. 
  495.  
  496. LOCATION: You may use the location field for
  497. either a classification number (if your organization
  498. system is that evolved) or simply where you have
  499. stored the physical item referenced in the BIBL
  500. record.
  501.  
  502. II. SEARCHING THE DATABASE
  503.  
  504. To search, press S at the main menu, then via the
  505. light bar select which field you wish to search
  506. (Author, Title, Subject, etc.). Once you have selected
  507. the field you wish to search, a 'QUERY' box will
  508. appear. Enter the text you wish to locate in this box,
  509. at the 'Query >>' prompt.
  510.  
  511. You may search text in ANY field of a BIBL record.
  512. Matches are made using your input as a stem; that is,
  513. if you enter SMI and SMITH exists, you'll get a
  514. match (it's called implied truncation). Note that while
  515. retrieval on indexed fields is very fast, searching
  516. non-indexed fields (e.g., line 3 of the note field) is
  517. slower. You may abort a non-indexed search by
  518. pressing any key to interrupt.
  519.  
  520. On searches, BIBL first reads through the database
  521. collecting matching records, then shows them (e.g.,
  522. Match 1 of 50). BIBL will collect only the first 1000
  523. matches. If you have more than 1000 matches, you
  524. will receive a message noting that the match limit
  525. was exceeded. You should narrow your search.
  526.  
  527. On indexed field searches, if BIBL can not find a
  528. match for your query, it will display several index
  529. entries that come before and after where your query
  530. would have fallen in the index. As your database
  531. grows, this becomes more useful.
  532.  
  533. If you want to abandon searching after you have
  534. selected a particular field to search, press RETURN
  535. instead of entering a search statement at the 'Query
  536. >>' prompt. You will be returned to the main
  537. menu.
  538.  
  539. BOOLEAN SEARCHING (AND / OR / NOT)
  540.  
  541. Use BOOLEAN search to search for up to 4 terms in
  542. a record. You may search either the full record or
  543. limit the search to the keyword field. When the full
  544. record is searched, a high speed search algorithm
  545. (Boyer-Moore) is employed--this yields a significant
  546. performance improvement over searching just the
  547. keyword field--where BIBL uses a more traditional
  548. approach (reading each record and comparing the
  549. field to your input).
  550.  
  551. Registered version supports dumping the results of a
  552. boolean search to disk. You may select either BIX
  553. format (for subsequent transfer to another database)
  554. or plain ASCII (no labels, formatted like
  555. QUERY.TXT entries).  You give BIBL a name for
  556. the output file and based on your format choice, the
  557. extension (BIX or TXT) is automatically appended.
  558. LAN users: If you have directed BIBL to look on a
  559. remote drive for the database (via BIBLPATH.CFG),
  560. the BIX file will be put where BIBL.EXE resides,
  561. not where the database (*.DAT and *.IX file)
  562. resides.
  563.  
  564. III. EDITING/DELETING RECORDS 
  565.  
  566. You may enter EDIT mode either via a search or by
  567. the LIST function (press E when the desired record
  568. displays). As you first enter EDIT mode, the author's
  569. name field will be highlighted. Make any changes
  570. you desire. See Appendix C for editing keystrokes
  571. that are supported by BIBL's editor. When you have
  572. finished making changes, press ESC. If you've made
  573. changes, you'll be prompted as to whether you want
  574. to replace the record in the database with this new
  575. version.
  576.  
  577. Y - The index will be updated if changes were made.
  578. N - Changes will be discarded. Original redisplays.
  579.  
  580. You may also enter EDIT mode via the 'List records
  581. in the database' option from the main menu. The only
  582. difference between editing from this menu choice
  583. instead of SEARCH is that BIBL will display all
  584. records in the database, beginning with the last
  585. record.
  586.  
  587. IV. SYSTEM MAINTENANCE
  588.  
  589. The MAINTENANCE function offers several
  590. options:
  591.  
  592. - Convert Shareware to REGISTERED.
  593. - Rebuild Indexes
  594. - Call External Editor/Call Up Any ASCII files
  595. - Shell to DOS
  596. - Install Editor/Viewer
  597. - UnInstall Editor/Viewer
  598. - Make a new database
  599. - Delete a database
  600. - ASCII Import (Read BIX files)
  601. - Global Change
  602. - Backup database (create archive)
  603. - Check linked files
  604. - Total Value field for database
  605.  
  606. A. CONVERT SHAREWARE to REGISTERED.
  607.  
  608. When you register, you will receive by return mail a
  609. registration number. Select option C under the
  610. Maintenance sub-menu, then enter the number
  611. EXACTLY as it appears. BIBL will verify that it is
  612. a valid number (we do some check-digit math in case
  613. you're interested in such things) and will then create
  614. an ASCII file (BIBL.REG) which stores that number.
  615. From then on, when BIBL activates from the DOS
  616. prompt, it will read that file, verify the number, and
  617. present you the user with a registered version of the
  618. program.
  619.  
  620. The real value is that forever more you can upgrade
  621. any SHAREWARE release to REGISTERED, just by
  622. entering your secret number. Actually, as long as you
  623. leave BIBL.REG in your BIBL sub-directory, the
  624. upgrade process will be automatic. You won't have
  625. to check our BBS for the latest registered version or
  626. have to send us a disk or pay the extra $ 10.00 to
  627. receive one by return mail. If you see a newer
  628. shareware version on a BBS or CompuServe,
  629. download it and immediately have the benefits of an
  630. upgraded registered version.
  631.  
  632.  
  633. B. REBUILDING INDEXES
  634.  
  635. BIBL includes an index rebuild function to create new
  636. indexes from the database file on demand. You may
  637. never need this function but if you have to rebuild
  638. your file using BRX (which does not do a complete
  639. job of indexing your file ), or wish to physically
  640. purge deleted records from your file, this option will
  641. perform the task.
  642.  
  643. C. CALL EXTERNAL EDITOR/VIEW ASCII FILE
  644.  
  645. You may view your savefile (QUERY.TXT) or any
  646. other ASCII file from within BIBL. The viewer built
  647. into BIBL is quite powerful and can view ASCII files
  648. of any size.  It responds to a mouse, if you have one
  649. installed.
  650.  
  651. Viewer Commands:
  652.  
  653.               PgDn = move down one screen
  654.               PgUp = move up one screen
  655.       Control-PgUp = go to top of file
  656.       Control-PgDn = go to bottom of file
  657.       Escape (or)
  658.  RightMouse button = Exit viewer
  659.  
  660. External viewer.  If you have an external program
  661. linked to BIBL, that program is called and passed the
  662. name of the file you want to view. 
  663.  
  664. D. SHELL TO DOS
  665.  
  666. BIBL allows you to drop out of the program
  667. momentarily and return to your DOS prompt. This
  668. option allows you to delete files, use a program like
  669. LIST to view a file, check disk space, or do other
  670. DOS-type things. All but 47K of your RAM is
  671. returned to the system for the DOS prompt.
  672.  
  673. When you type EXIT, BIBL will reactivate and check
  674. to see that the operating system is still defaulting to
  675. the sub-directory where your BIBL files are kept. If
  676. not, BIBL will change to that drive and directory
  677. before continuing. If BIBL is unable to change to the
  678. original sub-directory, you will receive a message to
  679. that effect...so you can manually issue the command
  680. (e.g., CD\BIBL <cr>) from the  DOS prompt.
  681.  
  682. E. INSTALL EDITOR/VIEWER
  683.  
  684. BIBL allows you to specify some program other than
  685. BIBL to handle viewing of your save file or other
  686. text files as well as editing and printing of reports.
  687.  
  688. The program you use must be capable of accepting an
  689. ASCII file as a command line argument (e.g., WP
  690. filename <cr>). BIBL will send the name of your
  691. external program (drive, path, program name and
  692. extension) to DOS as well as the name of the file
  693. (drive, path, filename, and extension). This allows
  694. you to access an external program on another drive
  695. if desired.
  696.  
  697. BIBL uses a simple configuration file (BIBL.INI) to
  698. store various system defaults. To install an external
  699. editor/viewer (in this example, WordPerfect 5.1), the
  700. following line is added to that file:
  701. EDIT=C:\WP51\WP.EXE
  702.  
  703. To uninstall the editor, either install a different
  704. program via the Install routine under Maintenance, or
  705. simply delete the EDIT= line from BIBL.INI
  706.  
  707. BIBL swaps most of itself out to disk (or EMS if
  708. available), freeing up more system memory for your
  709. editor/viewer. EMS will be automatically used if
  710. available, next XMS is tried, then finally to disk.
  711. While the program normally requires 460K or more
  712. to run, after compressing itself and swapping out, a
  713. 45-50K kernel of BIBL remains in memory--enabling
  714. you to use a very large program (e.g., WordPerfect)
  715. as your editor/viewer.
  716.  
  717. When the external program finishes, BIBL returns!
  718.  
  719. Once installed, the name of the viewing program (no
  720. extension) appears on the BIBL main menu in the
  721. VIEW option bar.
  722.  
  723. F. MAKE A NEW DATABASE.
  724.  
  725. To create a new, empty database, press M on the
  726. maintenance menu, then enter a name for the
  727. database file. You may enter up to 8 letters for your
  728. database name. You should try to give the file a
  729. name that will later give some indication of the file's
  730. contents.
  731.  
  732. TIP: When creating databases, give your most
  733. popular file a name that sorts first. The Database
  734. Selection option on the main menu sorts the various
  735. *.DAT files before displaying them. The first file in
  736. the list will be highlighted when the list displays. If
  737. it is the file you want, just press RETURN (or ESC). 
  738. Note that you can also specify a database on the
  739. command line when activating BIBL from the DOS
  740. prompt (e.g., BIBL Myfile).
  741.  
  742. G. DELETE A DATABASE.
  743.  
  744. You may use this function to delete a database and
  745. it's associated index file. You may also delete a
  746. database and index simple using the DOS delete
  747. command while at the DOS prompt. BIBL
  748. dynamically determines your databases by scanning
  749. the directory where BIBL.EXE resides for files
  750. ending with the *.DAT extension. You may NOT
  751. DELETE the database you are currently using.
  752.  
  753. You should not use the DAT extension for any export
  754. files you create, nor should you have any file with a
  755. DAT extension (that's not a BIBL database) in your
  756. BIBL subdirectory...if you do, BIBL will assume it's
  757. a database and present the file as a valid choice.
  758.  
  759. H. ASCII Import
  760.  
  761. Using the ASCII import option enables you to read
  762. any labelled ASCII file into the currently active BIBL
  763. database. The file separated with **'s and each line
  764. is labelled. The labelled option under the Export
  765. Menu creates this format as does the Transfer option
  766. when displaying an individual record.
  767.  
  768. If you want to experiment with ASCII import (say
  769. you're trying to import an ASCII file from some
  770. other source--like bibliographic data downloaded
  771. from a CD-ROM), you should follow these steps:
  772.  
  773. 1. Use MAKE A NEW DATABASE option on
  774. maintenance menu to create a database called
  775. something like TEST 
  776. 2. Use DATABASE SELECTION on the main
  777. menu to select the TEST database.
  778. 3. Run ASCII import from the maintenance
  779. menu. You BIX file must be in the same subdirectory
  780. where BIBL.EXE resides.
  781. 4. After reviewing the results (the records
  782. added to TEST), select the database you want to use
  783. and run ASCII import again. When finished, you can
  784. delete TEST.DAT and TEST.IX via Delete a
  785. Database (on the maintenance submenu).
  786.  
  787. For downloads from ERIC, ABI/Inform, PsycInfo,
  788. Medline and/or NOTIS get MAKEBIX...from the
  789. GMUtant BBS or Compuserve (IBM APPS). Note: It
  790. comes with the registered version of BIBL.
  791.  
  792. I. GLOBAL CHANGE
  793.  
  794. You may make global changes ('find & replace') to
  795. text in any record across your database. The
  796. unregistered version is limited to making these global
  797. changes on the Subject and/or location fields. The
  798. registered version of BIBL allows you to change the
  799. text in any field of all records for a given database.
  800.  
  801. To make a global find and replacement, select the
  802. field you want to modify (the database will be the
  803. currently active file--the database that displays on the
  804. status bar at the bottom of your screen). After
  805. selecting the field to modify, you must next enter the
  806. original text (what's currently in the record(s)) and
  807. then the new text. You may instruct BIBL to ignore
  808. case when attempting to match or to consider a match
  809. valid only when the case is the same.
  810.  
  811. TIP:    Be advised that the substitution you instruct
  812. BIBL to make will occur anywhere BIBL finds a
  813. match for your 'change' text. Without a bit of
  814. thought on your part, this can quickly become a
  815. nightmare. 
  816.  
  817. If you elect to change a short word--one that also
  818. appears as part of a larger word in the same
  819. field--you can have problems. For example, changing
  820. NETWORK to LAN can (if you also have
  821. NETWORKING in the field) lead to LANING...
  822.  
  823. V. EXPORT (REPORTS / BIBLIOGRAPHIES)
  824.  
  825. While BIBL offers only limited print support, it will
  826. dump your database to disk in an ASCII file--which
  827. you can then edit and print using your favorite word
  828. processor. Where you are given the option of naming
  829. the file, you should use a *.TXT extension when
  830. possible. This will allow you to see all available
  831. export files under the CALL EXTERNAL EDITOR
  832. function which has a *.TXT mask.
  833.  
  834. The registered version also supports creation of a
  835. new database under bibliographies. Using this
  836. option gives you an 'automatic' way to move
  837. groups of records from one database to another.
  838. It also provides an easy way to get the formatting
  839. power offered by the 'User-Selects' export option
  840. applied to a bibliography (since 'user-selects'
  841. works only on a complete database).
  842.  
  843. Registered version supports bibliography creation on
  844. ANY field in the record. The registered version of
  845. BIBL also provides the option to create output files
  846. using soft returns instead of hard ASCII returns) after
  847. each line. This greatly simplifies subsequent editing
  848. if using a word processor that supports scalable fonts.
  849.  
  850. Annotated form will produce a listing with author,
  851. title, publisher and the notes fields. Brief includes
  852. only the author, title and publisher field. 
  853.  
  854. You assign the name for the bibliography output file.
  855. If the name is already in use, BIBL asks you to use
  856. another name. Note that using the Word Processing
  857. [WP] format option will produce a citation where
  858. fields follow one another on a line. A hard return
  859. follows the PUBL field.
  860.  
  861. Smart Punctuation.
  862.  
  863. As BIBL creates your bibliography, it will check to
  864. see if each field ends with punctuation. If so, the
  865. existing punctuation will be written to your file. If
  866. not, BIBL will add periods after each field. This
  867. saves you having to use end-of-field punctuation in
  868. your BIBL database entry.
  869.  
  870. DELIMITED FORMAT
  871.  
  872. Delimited format is used when you want to move
  873. your BIBL database to dBASE or some other
  874. database system (why?). The next few paragraphs
  875. point out a few things you should be  aware of:
  876.  
  877. Note that in delimited format BIBL will change any
  878. quotation mark that appears in the Title, Keyword or
  879. Note fields to a single quote--to preserve the exported
  880. data's integrity. If any double quotes were to appear
  881. in the exported data (that is, anywhere other than
  882. between the fields), the importing program might not
  883. process the data correctly.
  884.  
  885. For example, if you have: Jones is author of the
  886. article, "This is My Life's Work." in your note field,
  887. under delimited format, BIBL will export: "Jones is
  888. author of the article, 'This is My Life's Work.'"
  889.  
  890. A CR/LF appears at the end of each record. dBASE
  891. will accept this for input if you first set up a dBASE
  892. file with the proper structure. Multi-line fields (e.g.,
  893. author, title, publisher but not note) are combined
  894. into single comma-quote delimited strings. You can
  895. calculate the maximum length by consulting the
  896. record format at the end of this documentation (for
  897. example, a author field can be up to 140 characters
  898. long -- since it is composed of two 70 character
  899. lines).
  900.  
  901. LIST SUBJECTS/LIST KEYWORDS
  902.  
  903. You should use these export functions periodically to
  904. check the uniformity of your subject headings and
  905. descriptor fields. For example, if your list shows you
  906. have ten items under computer and one under
  907. computers, you should edit the COMPUTERS entry
  908. (changing it to COMPUTER). 
  909.  
  910. Note that there is an entry in the list for each heading
  911. in a record (if you have 10 records with the subject
  912. BASEBALL, you'll get 10 entries for BASEBALL in
  913. the SUBRIEF.TXT file).
  914.  
  915. KEYWORD.TXT - this option lists all terms used in
  916. the keyword field of your database. With each term,
  917. the number of times it appears is also listed. This list
  918. can be a big help in eliminating redundant terms and
  919. consolidating similar terms to yield a stronger
  920. database.
  921.  
  922. Titles/Keys.  The registered version of BIBL supports
  923. an additional export function--listing all titles in a
  924. database sorted by keyword. Here's an example using
  925. the demo database included with BIBL (the titles have
  926. been truncated for this example):
  927.  
  928. INFORMATION-CENTERS 
  929.  
  930.    Electronic Information Delivery Systems: Reports
  931.  
  932. INFORMATION-RETRIEVA
  933.  
  934.    A Priori Analysis of Natural Language Queries.
  935.    Alphabetical Searching in an Online Catalog.
  936.    Prospects for Knowledge-Based Customization of
  937.    The Organization of Free Text Databases.
  938.  
  939. INFORMATION-STORAGE 
  940.  
  941.    Optical Storage and OCR - Key Components of
  942.    Processing Truncated Terms in Document Retrieval
  943.  
  944. Note that the term "INFORMATION RETRIEVA" is
  945. the first 20 characters of the term
  946. INFORMATION-RETRIEVAL.  Remember that
  947. BIBL truncates any keyword at twenty characters...so
  948. where you've used a longer term in your database, it
  949. will be shortened in this export file.  You will have
  950. to edit the resulting export file with your word 
  951. processor to restore the truncated characters.
  952.  
  953. Related Topics
  954.  
  955. Send To Disk. Beyond creating large reports, during
  956. any search you may elect to send a copy of a single
  957. record to an ASCII file (QUERY.TXT). Each time
  958. you press 'S' a copy is appended to this file. When
  959. you are finished with the file, delete it (via DOS) or
  960. rename it. Then when you next send a record to disk,
  961. BIBL will create a new copy of QUERY.TXT. When
  962. running under Windows 3.1, the 'Send' command
  963. becomes 'Clip'. Data is sent to the Windows
  964. clipboard (see Appendix D at the end of the
  965. documentation).
  966.  
  967. Transfer: Any time an individual record is displayed,
  968. you have the option of copying it to a transfer file
  969. (TRANSFER.BIX). Pressing T (or clicking on the
  970. word 'Transfer' will add the record to
  971. TRANSFER.BIX.
  972.  
  973. To move the records in TRANSFER.BIX use ASCII
  974. import on the maintenance menu.  Be sure to delete
  975. any existing TRANSFER.BIX file if you want to
  976. make a file of new records...if TRANSFER.BIX
  977. exists on your disk, transferred records will be
  978. appended to it. If it is missing when 'T' is pressed,
  979. BIBL will create a new copy of it.
  980.  
  981. Registered users can also transfer records in groups,
  982. based on text occurring in any field. Select
  983. Bibliographies/Transfer on the Export menu, then
  984. proceed as you would when creating a bibliography.
  985.  
  986. When prompted for output format, select Database.
  987. You will next be asked if you want to delete
  988. transferred records from your original file. You may
  989. want to run this option once before you go back and
  990. ask BIBL to delete copied records (just to verify that
  991. you did retrieve the records you wanted AND to
  992. insure that you were able to import them to another
  993. database successfully).
  994.  
  995. IMPORTANT Once you ask BIBL to delete these
  996. records, they will be gone...deleted from the original
  997. database which will then be packed and re-indexed
  998. before returning to the Main Menu!
  999. USAGE NOTES / TIPS
  1000.  
  1001. A. Here are some of the ways we've heard BIBL is
  1002. used:
  1003.  
  1004. - as an online index to a personal book collection.
  1005. - tracking magazine articles.
  1006. - a videotape collection for a large university is
  1007.   cataloged using BIBL/NET.  The network version of
  1008.   BIBL is used so that simultaneous access is provided
  1009.   even as the library staff add records.
  1010. - indexing a vertical file (for non-library types, a
  1011.   vertical file is usually a filing cabinet of clippings,
  1012.   brochures, etc.).
  1013. - using BIBL instead of 3x5 cards for research.
  1014. - tracking reserve reading materials in a corporate  
  1015.   library.
  1016. - with /p (OPAC) switch set, running BIBL as a
  1017.   DOOR on a BBS to provide users an online catalog.
  1018. - Managing an office library.
  1019. - Several computer centers use BIBL to track their
  1020.   documentation collection.  Using BIBL/NET works
  1021.   particularly well for this application.
  1022. - A public service agency has 50+ copies of BIBL.
  1023.   The home office creates databases and sends them out
  1024.   to branches. With OPAC mode set, the integrity of
  1025.   the files is preserved.
  1026.  
  1027. B. Using WordPerfect as your external editor (or viewer
  1028. or printer) with BIBL.
  1029.  
  1030. While BIBL does not possess a direct interface to
  1031. WordPerfect it does work particularly well with
  1032. version 5.1 of that software.
  1033.  
  1034. Follow the sequence below to install WordPerfect as
  1035. your editor/viewer:
  1036.  
  1037. Note: the sequence is the same for any
  1038. word-processor...just be sure that the program
  1039. accepts a filename to edit on the command line (e.g.,
  1040. WP MYFILE [RETURN] on the DOS command line
  1041. will start WordPerfect and load a file named
  1042. MYFILE). WordStar also behaves this way as do
  1043. other programs.
  1044.  
  1045. 1. Select MAINTENANCE from the BIBL main
  1046. menu (press M) 
  1047. 2. Press I (Install Editor/Viewer).
  1048. 3. Enter the full path name to your copy of WP.EXE
  1049. (e.g., C:\WP51\WP.EXE).
  1050.  
  1051. Now, when you select CALL UP ASCII FILE under
  1052. the MAINTENANCE option, BIBL will load
  1053. WordPerfect and pass along the name of the file you
  1054. want to view, edit or print. When you are finished
  1055. with the document, press F7 to save and then exit
  1056. WordPerfect...you will be returned to BIBL. The file
  1057. you worked on is stored on the drive and
  1058. sub-directory where BIBL.EXE resides.
  1059. C. Remote Drives / LAN usage (registered version
  1060. only).
  1061.  
  1062. You may store your database and index files on a
  1063. drive/sub-directory other than were the BIBL.EXE
  1064. file is kept. This will allow you to use BIBL on a
  1065. LAN or in an environment where disk drives are
  1066. shared between users. While this version of BIBL is
  1067. a single user product (BIBL/NET is also available)
  1068. you can store your database and index on the server
  1069. disk.
  1070.  
  1071. IMPORTANT: BIBL databases MUST reside in a
  1072. subdirectory, not the root directory, of any remote
  1073. drive you use. For example, say you want to put a
  1074. BIBL database and index (*.DAT and *.IX) file on a
  1075. RAM disk. Be sure to create a subdirectory on your
  1076. RAM drive and move the files there. Do not simply
  1077. create a drive (e.g., D:) and copy the files there. If
  1078. you try to run BIBL using a root directory, you'll get
  1079. a error about locked databases and the system won't
  1080. operate!
  1081.  
  1082. To point BIBL to some location other than the
  1083. drive/directory where BIBL.EXE resides, you must
  1084. add the PATH= statement to BIBL.INI
  1085.  
  1086. PATH=X:\XXXXX
  1087.  
  1088. where X:\XXXXX is the full pathname of the
  1089. subdirectory you want to use for storing the database
  1090. & index file. 
  1091.  
  1092. D. Using BIBL's [WP] format with WordPefect.
  1093.  
  1094. Here's how you create a WordPerfect-ready version
  1095. of your database, (printing author, title and publisher
  1096. fields), sorted by Author, then title:
  1097.  
  1098. 1. Press E on the BIBL main menu (EXPORT).
  1099. 2. Press M (user-selects).
  1100. 3. Answer 'Y' that you want to continue.
  1101. 4. Enter 123 and press return (to indicate that you
  1102. want fields one (author), two (title) and three
  1103. (publisher). 
  1104. 5. Enter 'Y' to indicate that you're satisfied with
  1105. fields.
  1106. 6. Enter 1 to indicate that sort should be on author (it
  1107. will actually be on author, then title within author).
  1108. 7. Enter 'E' to indicate that you want [WP] format.
  1109. 8. Enter the name you want to give your output file.
  1110.  
  1111. If you are using WordPerfect as your external editor,
  1112. once BIBL finishes making your file and returns to
  1113. the main menu, press M (for Maintenance), then
  1114. press C to 'CALL External Editor, enter the name
  1115. you gave the file in step 8 (or just hit return and pick
  1116. from the *.TXT files displayed), then sit back as
  1117. BIBL compresses itself, then loads WordPerfect
  1118. (passing along the name of your file).
  1119.  
  1120. If you need to reset your margins (because the text is
  1121. wrapping around incorrectly), go to the top of the
  1122. document and press SHIFT-F8, then L (for Line),
  1123. then M for margins. 
  1124.  
  1125. E. Modifying HELP display (INFORMATION on the
  1126. main menu). 
  1127.  
  1128. BIBL displays the file BIBL.HLP when 'I' is pressed
  1129. on the Main Menu. If you want to change the help
  1130. display file, just rename any ASCII file to BIBL.HLP
  1131. and BIBL will display it...
  1132.  
  1133. F. BACKUP? Many users have found that using the
  1134. LABELLED option under Export provides a
  1135. space-saving means of making a backup copy of your
  1136. database(s). Since only the data from your database
  1137. is exported (not the empty spaces inside each record),
  1138. the resulting file is usually about 40% smaller than
  1139. your database.
  1140.  
  1141. With ASCII Import (on Maintenance menu), you can
  1142. read this file back into BIBL should you ever need to
  1143. reconstitute your database.
  1144.  
  1145. Another backup option exists for users of PKZIP,
  1146. LHA or ARJ (archive utilities). You may use BIBL
  1147. to 'drive' any one of three third-party archiving
  1148. utility programs (LHA.EXE - .LZH files;
  1149. PKZIP.EXE - .ZIP files, and ARJ.EXE - .ARJ
  1150. files). The archiving program *MUST* be either in
  1151. your BIBL  subdirectory or in a sub-directory that is
  1152. included in your DOS path statement. If one of the
  1153. supported archiving programs is not found, BIBL will
  1154. ignore the request.
  1155.  
  1156. If it is found, BIBL compresses itself in memory
  1157. (down to about 57K), then launches the archiving
  1158. program. When it is finished, BIBL re-expands in
  1159. memory and continues running. If you have EMS
  1160. memory, BIBL will swap itself to EMS during this 
  1161. process (otherwise, it swaps to disk).
  1162.  
  1163. Both the data file (*.DAT) and the index file (*.IX)
  1164. are combined in the archive you create. Since BIBL
  1165. always initializes both records and index entries with
  1166. 0's before use, these programs achieve a compression
  1167. of 85 - 90%! Thus, you can probably fit a 2,000
  1168. record database (and index) on a 360K floppy. 
  1169.  
  1170. Technical Specs:
  1171.  
  1172. 1. Memory required. The shareware version of BIBL
  1173. requires at minimum 459K free RAM at the DOS
  1174. prompt when it loads.  The registered version
  1175. requires approximately 449 (286/386/486 version)
  1176. or 452K (8088 version). If you have EMS memory available
  1177. and are using the registered 286/386/486 version, then
  1178. BIBL needs approximately 432K free RAM at the DOS prompt
  1179. (since index buffers are moved to EMS).
  1180.  
  1181. 2. Pascal Record Structure
  1182.          
  1183. bookrec = RECORD
  1184.  recordstatus : longint;
  1185.             link  : string[30]; {linked files}
  1186.             value : string[6];  {value/cost field}
  1187.           author1 : string[70];
  1188.           author2 : string[70];
  1189.            Title1 : string[70];
  1190.            title2 : string[70];
  1191.            title3 : string[70];
  1192.              publ : string[70];
  1193.             publ2 : string[70];
  1194.             class : string[40];
  1195.          subject1 : string[30];
  1196.          subject2 : string[70]; {descriptor field}
  1197.             flag1 : char; {Used by BIBL/NET}
  1198.             flag2 : char; { "    "    "    }
  1199.             flag3 : char; { "    "    "    }
  1200.        createdate : string[7]; {creation date}
  1201.             note1 : string[70];
  1202.             note2 : string[70];
  1203.             note3 : string[70];
  1204.             note4 : string[70];
  1205.             note5 : string[70];
  1206.             note6 : string[70];
  1207.             note7 : string[70];
  1208.             note8 : string[70];
  1209.             note9 : string[70];
  1210.             note10 : string[70];
  1211.            end;
  1212.  
  1213. Indexes (the following keys are maintained in each
  1214. .IX file):
  1215.  
  1216. Author   first 15 characters of field 
  1217. Title    first 15 characters of the field
  1218. Keys     each word of the field is extracted
  1219.  
  1220. Up to 20 characters of each 'word' is indexed.Up to
  1221. 9 words from any one line are indexed. If you have
  1222. 10 words on the line, the ninth is ignored.
  1223.  
  1224. IMPORTANT: place a '-' between words you want
  1225. BIBL to index together.
  1226.  
  1227. A fourth index is reserved for 'on-the-fly' reports
  1228. (bibliographies, sort on publisher or location field,
  1229. etc). Data stored in this index is compressed (to allow
  1230. larger text values to be represented.
  1231.  
  1232. The key length is 15 characters although with data
  1233. compression, 20 characters are used to build the
  1234. key). During bibliography production (Option D on
  1235. Export Menu), the key value for this fifth index is:
  1236. author (14 characters)+title (6 characters) which
  1237. yields an author/title sort.
  1238.  
  1239. During User-Defined output (Option M on Export
  1240. Menu), with a sort on the location field (field #4), the
  1241. sort key is location (15 characters)+author (5
  1242. characters), to yield a location/author sort.
  1243.  
  1244. If publisher field sort is selected for Option M, then
  1245. 20 characters of the publisher field are used to
  1246. generate the key.
  1247. File extensions used by BIBL:
  1248.  
  1249. .DAT - a datafile
  1250. .IX  - the index to a DAT datafile.
  1251. .HLP - Help file (displays when I is pressed on Main Menu)
  1252. .SAV - temporary file, used during index rebuild/purge.
  1253. .DBL - ASCII file used to store display text modifications for
  1254.        a particular database.
  1255. .INI - As in BIBL.INI, an ASCII text file used for configuration data.
  1256.        Create or edit this file with an ASCII editor or use the
  1257.        MAKEINI.EXE utility (included with registered version).
  1258.  
  1259. The *.DAT and *.IX files together form 'a database.'
  1260. You must have the same name on both you .DAT
  1261. and .IX files--usually taken care of by BIBL but if
  1262. you rename a database via DOS (for example,
  1263. renaming DEMO.DAT to MYFILE.DAT, be sure to
  1264. rename DEMO.IX to MYFILE.IX too!). If you
  1265. modify the labels, this 'database' will also include a
  1266. *.DBL file.
  1267.  
  1268. .TXT - any ASCII file.
  1269. .BIX - BIBL Import/Export. A labelled ASCII file.
  1270.        This file uses a specific format where each field is
  1271.        labelled (e.g., A1:, A2: for the 2 author fields, T1:
  1272.        T2: T3: for the title fields, and so on.  Each record
  1273.        in the file is separated by '**'. The ASCII import
  1274.        function on the Maintenance Menu will read a BIX
  1275.        file and write the information to BIBL records. You
  1276.        can use this facility for backing up your database or
  1277.        moving records from one database to another.
  1278.  
  1279. TIP. Many users find BIX files are great for doing
  1280. massive edits across a database (assuming you have
  1281. an ASCII editor or know how to save an ASCII file
  1282. from within your favorite word-processor).  Just
  1283. export your database as a BIX file, then use your
  1284. editor to make global changes across the file. When
  1285. you're finished, save it back as a plain ASCII file
  1286. (e.g., CTRL-F5,Text,Save in WordPerfect). Create
  1287. a new database structure within BIBL to hold this
  1288. new data (we don't want to import it into the same
  1289. database we used to get the BIX file or we'll have
  1290. duplicates). Import it into the new database via
  1291. Maintenance. When you're convinced it all worked
  1292. correctly, just delete the older version of the
  1293. database.
  1294.  
  1295. BIBL.EXE has been compressed with PKLITE version 1.15
  1296.  
  1297. Questions, comments, complaints, encouragement???
  1298.  
  1299. Clyde W. Grotophorst, Route 1, Box 296, Hamilton,
  1300. Virginia 22068  voice: (703) 993-2239 or call the
  1301. GMUtant OnLine BBS (703) 993-2219, and leave a
  1302. comment for the Sysop. You may also reach the
  1303. author via Compuserve (70404,3376), or via the
  1304. internet (wallyg@fen1.gmu.edu).
  1305.  
  1306. Appendix A      Modifying field display text
  1307.  
  1308. Beginning with release 7.1, it is possible to modify
  1309. the way BIBL refers to certain fields in a particular
  1310. database.  Note: this functionality is restricted to
  1311. modifying the LOCATION field in the
  1312. SHAREWARE version.
  1313.  
  1314. A BIBL record defaults to the following field labels
  1315. (not all the note field is shown for brevity sake): 
  1316.  
  1317. Auth:
  1318.      :
  1319. Title:
  1320.      :
  1321.      :
  1322.  Publ:
  1323.      :
  1324.  Locn:                                        
  1325. Date:
  1326.  Subj:                                       
  1327. Value:
  1328.  Desc:
  1329.  Note:
  1330.      :
  1331.  
  1332. It is possible to modify these labels on the record
  1333. display screen, the data entry screen and the edit
  1334. screen.  To do so, you must create an ASCII file
  1335. similar to the one shown below.  In the sample
  1336. below, we want to modify the Location field (uses
  1337. the label Locn: in the above example) to show Class:
  1338. (as in classification). 
  1339.  
  1340. First, with an ASCII editor create a file with the
  1341. same filename as the database you want to perform
  1342. this modification on...but give the file a DBL
  1343. extension.  For example, say you wanted to modify
  1344. the DEMO.DAT database that comes with BIBL,
  1345. you'd create a file named DEMO.DBL
  1346.  
  1347. Using the convention established with BIX files
  1348. (where each field is labelled), you'd enter the
  1349. following line in the file:
  1350.  
  1351. CL=Class:
  1352. CLMENU=Call Nmbr
  1353.  
  1354. The CL= line governs what label BIBL will use for
  1355. that field when displaying a record. The CLMENU=
  1356. line governs how BIBL will refer to the field on the
  1357. SEARCH and EXPORT menu screens. 
  1358.  
  1359. Limitations: The label text can be no more than 6
  1360. characters. The menu text can not exceed 9
  1361. characters.
  1362.  
  1363. Any field you do not modify in your *.DBL file will
  1364. retain the BIBL default value.
  1365. Here's a complete sample file for a database that's
  1366. being used not as a book catalog but as a faculty
  1367. directory:
  1368.  
  1369. A1= Name:
  1370. A2=Phone:
  1371. T1=Membr:
  1372. PB= Dept:
  1373. P2= Schl:
  1374. CL= Rank:
  1375. SU=Rsrch:
  1376. DE= Desc:
  1377. N1= Note:
  1378. VL= Cost:
  1379. AUMENU=Professor
  1380. TIMENU=Membrship
  1381. DEMENU=Descrptor
  1382. PBMENU=Affiliate
  1383. SUMENU=Research
  1384. CLMENU=Rank
  1385.  
  1386. With these 13 lines (and yes, each entry must occupy
  1387. a single line and begin in the first position of the left
  1388. margin), we change the look of this one database...all
  1389. other BIBL databases (unless they too have a
  1390. corresponding DBL file) will use the BIBL
  1391. book-oriented defaults.
  1392.  
  1393. Any BIBL field label can be modified. Six fields may
  1394. be renamed throughout the program: Author, Title,
  1395. Publisher, Keywords, Location and Subject.
  1396.  
  1397. When you delete a database that has an associated
  1398. DBL file, BIBL will ask if you want that label file
  1399. removed as well.  Leaving it causes no problems
  1400. other than consuming a few hundred bytes of disk
  1401. space. 
  1402.  
  1403. You may use WordPerfect to create a label
  1404. configuration file but be sure to save the file using
  1405. CTRL-F5 (text out).
  1406.  
  1407. If you want a database to revert to the original default
  1408. labels and field names, just delete the associated
  1409. *.DBL file for that database.
  1410.  
  1411.                      ** IMPORTANT **
  1412.  
  1413. The operation of the program is not changed by these
  1414. modifications.If, for example, you do as we've
  1415. shown in the sample above and divide the author field
  1416. into 2 fields (one for name and one for phone), BIBL
  1417. will still treat them as an entity when producing
  1418. reports -- which in this case would concatenate (or
  1419. join) them.  Finally, when assigning values to
  1420. AUMENU, TIMENU, CLMENU and SUMENU, be
  1421. sure that you *DO NOT* have the same letter
  1422. beginning more than one values--or use the same first
  1423. letter as is used by one of the fields that you can not
  1424. change (e.g., D for Descriptor).
  1425.  
  1426. In several instances during operation, BIBL will
  1427. accept the initial letter of the strings you assign as the
  1428. hot key. If two begin with the same letter, pressing
  1429. that letter will always activate the first term (for
  1430. example, don't have AUMENU=Editor and
  1431. SUMENU=Edition -- both begin with an E).
  1432.  
  1433. Appendix B.  Value field
  1434.  
  1435. Beginning with release 7.4, BIBL will now track a
  1436. value for each item in a database.   Many users have
  1437. requested this field (to help with insurance valuations
  1438. of their collections).  The value field is limited to 6
  1439. spaces (so you can store between 0 - 999.99 for a
  1440. given item).  Should you have an item worth more
  1441. than 999.99 you can omit the decimal and track
  1442. values up to 999999.  When BIBL computes the total
  1443. value for a database, it will treat 999999 as
  1444. 999999.00.
  1445.  
  1446. The value field label may be changed (using VL= in
  1447. the *.DBL file). Value appears only in the BIX file
  1448. (label VL=) or under the USER-SELECTS option
  1449. under export. It can be read into a BIBL record when
  1450. using ASCII import. 
  1451.  
  1452. Do not include a $ in your value for an item (e.g.,
  1453. don't enter $ 5.00 -- use 5.00 instead).  BIBL will
  1454. replace any  $'s found with 0's.
  1455.  
  1456. Appendix C. Editing keystrokes supported (use
  1457. during ADD and/or EDIT):
  1458.  
  1459. If you know WordStar (or use one of the Borland
  1460. editors), you'll find most of BIBL's edit commands
  1461. perform as you'd expect ( ^ = Control key):
  1462.  
  1463. ^F or CTRL ->  word right      ^S - character left
  1464. ^A or CTRL <-  word left       ^D - character right
  1465.  
  1466. ^T -  delete word right  ^Y - delete line
  1467. ^E -  up one line        ^X - down a line
  1468. ^H -  backspace
  1469.  
  1470. ^ENTER  or ^KD  same as pressing ESCAPE.
  1471.  
  1472. If you're using a mouse, you can click on a field to
  1473. highlight it for subsequent editing. Clicking on a part
  1474. of the field moves the cursor to that spot.
  1475.  
  1476. When in the NOTE field, use ^B (Control-B) to
  1477. reformat text.
  1478. Appendix D. Windows 3.1 support
  1479.  
  1480. BIBL now offers support for the Windows clipboard. 
  1481. When you're running BIBL under Windows, the
  1482. 'Save' command that appears when an individual
  1483. record is on the display becomes the 'Clip'
  1484. command. Clicking on CLIP or pressing C will copy
  1485. the current record to the Windows clipboard.  The
  1486. following fields of the record are copied: author,
  1487. title, publisher, and note.  We don't move the
  1488. location, subject or keyword fields since we assume
  1489. you want to move a bibliographic citation.  Unlike
  1490. the appending action of the SAVE command, when
  1491. you send data to the Windows clipboard, it
  1492. overwrites anything currently stored in the
  1493. clipboard--so you have to move it from the clipboard
  1494. to another application before sending a second
  1495. record.
  1496.  
  1497. BIBL will run in a Window.  Use the PIF file
  1498. included in the distribution archive.  You can also use
  1499. the .ICO file included if you want a BIBL icon...
  1500.  
  1501. Note that sending data to the clipboard replaces
  1502. whatever was already there.
  1503.  
  1504. If you want to have MOUSE control of BIBL menus when
  1505. running under WINDOWS, be sure your mouse driver is
  1506. loaded *before* Windows begins.  The mouse driver
  1507. that loads as part of the Windows initialization will
  1508. not support mouse actions in DOS programs.
  1509.  
  1510. Appendix E.  Linked file (Text/Image) support
  1511.  
  1512. With release 8.0, we've added the ability to link files
  1513. to BIBL records. A new field has been added to each
  1514. BIBL record (shown as Link: on the add/edit screen). 
  1515. Any file you enter in that field (giving the full DOS
  1516. pathname) will be called when you press L.  The
  1517. shareware version of BIBL supports linking text files,
  1518. while the registered version adds support for PCX
  1519. image files.
  1520.  
  1521. How does it work?
  1522.  
  1523. When you display a record (either via list or as the
  1524. result of a search), BIBL checks the LINK field
  1525. before displaying the record. If the field contains a
  1526. file name, a 'marker' displays in the lower left corner
  1527. of the record. The marker is either [T] for a text file
  1528. or [I] for an image file. (Note: BIBL determines the
  1529. file type based on the extension. Files ending in
  1530. PCX, IMG, TIF, GIF, GEM, JPG or WPG are considered
  1531. images, all other extensions default to text).
  1532.  
  1533. If the record has a marker, then pressing 'L' (for
  1534. Link) will activate the linked file.
  1535. Image files (registered version only):
  1536.  
  1537. BIBL shells out to DOS, executing the image file
  1538. viewer listed in your BIBI.INI file.  If you're using
  1539. PCX images, and using the view utility included on
  1540. your distribution diskette (BIBLPCX.EXE), then
  1541. BIBLPCX is called and passed the name of the file in
  1542. the LINK: field. You can scroll around the image file
  1543. (PgUp, PgDn) and when finished viewing press
  1544. ESCAPE.  BIBLPCX exits and BIBL returns.  If you
  1545. are not using BIBLPCX, you must use a program that
  1546. is capable of accepting a filename on the command
  1547. line.
  1548.  
  1549. Text files (registered and shareware)
  1550.  
  1551. BIBL either passes the file name to its built-in
  1552. viewer, or if you have an external editor defined
  1553. (e.g., EDIT=xxxxx in your BIBL.INI file), then the
  1554. program swaps out to EMS, XMS or disk (in that 
  1555. order) and calls your external editor/viewer
  1556. program...passing along on the command line the
  1557. name of the file in the LINK: field.  When you finish
  1558. viewing the file, BIBL returns. 
  1559.  
  1560. NOTE that support for these links between files and
  1561. BIBL records is assisted by the CHECK LINKS
  1562. function under maintenance.  This function will run
  1563. through a BIBL database and verify that any file
  1564. listed in a record's LINK: field does in fact exist.  If
  1565. it can not be found, you'll be notified and offered the
  1566. opportunity to break the link; that is, delete the data
  1567. in the associated record's LINK: field.
  1568.  
  1569. BIBL shows significant performance gains when used
  1570. with a disk caching software package. At a minimum,
  1571. if you're using DOS 5 (good), activate SmartDrive.
  1572. If you have DR DOS 6 (better), use PCKWIK. There
  1573. are many other disk caching packages available from 
  1574. various software vendors. As with any disk-intensive
  1575. application, a defragmented disk is also a plus... 
  1576. Appendix F. BIBL.INI
  1577.  
  1578. Beginning with release 8.0, BIBL uses a configuration file (BIBL.INI)
  1579. to set various system options.  With release 8.45, we've added a small
  1580. utility to manage creation/updating of this file.  The information
  1581. that follows discusses the implications of various settings.
  1582.  
  1583. You may comment BIBL.INI if desired...just don't put anything
  1584. other than the value for a given line while on the line with
  1585. label.  Lines can be no longer than 60 characters. Labels must
  1586. begin flush with the left margin.
  1587.  
  1588. EDIT=
  1589.  
  1590. /* registered version recognizes these additional statments */
  1591.  
  1592. place your registration number of the REGIS= line. Once done,
  1593. you can delete BIBL.REG
  1594.  
  1595. REGIS=
  1596. PATH=
  1597. OPAC=
  1598. VIEW=BIBLPCX.EXE
  1599. HEAP=
  1600. WAIT=
  1601. EMS=
  1602.  
  1603. Description of statement usage:
  1604.  
  1605. E D I T
  1606.  
  1607. The label EDIT is used for viewing/editing/printing text
  1608. files. If you link files to records in a database, this
  1609. program will be used to view them. If you're linking in
  1610. ASCII files, you should probably use BIBL's built in
  1611. ASCII viewer--it can deal with files of any size...and
  1612. is mouseable.
  1613.  
  1614. V I E W
  1615.  
  1616. The label VIEW should contain the name of the file
  1617. associated with image files (PCX, GIF, TIF, IMG, or WPG).
  1618. If you are using the SHAREWARE version, you can put IMAGE
  1619. files in your records, but pressing L (to follow the link
  1620. will shell to DOS...you'll have to type the program that
  1621. views the image file and give it the file name.
  1622.  
  1623. If you're using the registered version of BIBL, list your
  1624. image file viewing program (e.g., BIBLPCX that comes with
  1625. the registered version of BIBL) on the VIEW= line.  BIBL
  1626. will call that program and pass the name of the file in
  1627. the LINK field...yielding a seamless display function.
  1628.  
  1629. O P A C
  1630.  
  1631. The label OPAC forces BIBL to run in read-only mode. Set
  1632. the OPAC label to OPAC=TRUE to force read-only mode...the
  1633. same outcome can be obtained by using the /p switch on
  1634. BIBL's command line (e.g., BIBL /p [return]).
  1635.  
  1636. P A T H
  1637.  
  1638. The label PATH= is used to set a path to the databases
  1639. (*.DAT and *.IX files) if you're running the program
  1640. from somewhere else...for example, a 2 floppy system
  1641. with BIBL.EXE and BIBL.INI on drive A: and the databases
  1642. on drive B:; or a network where you share a data drive.
  1643. Put the FULL PATH on the line...BIBL will delete any
  1644. \ it finds on the end of the path so you need add it.
  1645. (e.g., C:\BIBL\DATA ).
  1646.  
  1647. H E A P
  1648.  
  1649. You can force BIBL to use more than 40% of available RAM
  1650. for in-memory storage of index buffers...just put a
  1651. number on the HEAP= line.  If you have enough EMS memory
  1652. available, BIBL will ignore the HEAP= directive.  If you
  1653. have a HEAP= directive, BIBL ignores the availability of
  1654. EMS.  You can force BIBL to ignore EMS by setting EMS=No.
  1655.  
  1656. Caveats: the number must be at least 20K (e.g., HEAP=20000)
  1657. and it should probably be small enough that you leave yourse
  1658. 20K of extra heap for program operation.  To arrive at the l
  1659. possible number you can use, type MEM at your DOS prompt,
  1660. then subtract 490K from the figure shown (470K for BIBL and
  1661. a 20K margin). The result is the maximum you can use.  Using
  1662. more memory will speed up indexing operations (e.g., you wan
  1663. to import a large BIX file) and indexed searching (author,
  1664. title, keyword).
  1665.  
  1666. E M S
  1667.  
  1668. Registered users, set EMS=No to turn off use of EMS even if
  1669. you have it available on your system.
  1670.  
  1671. W A I T
  1672.  
  1673. Set this to Yes to pause the initialization reporting screen.
  1674. Useful when you're fine tuning memory usage for indexes.
  1675.  
  1676. Appendix G. dBASE Extraction.
  1677.  
  1678. A utility program BIBL2DB is included with the registered
  1679. version of BIBL to support converting a BIBL database into
  1680. a dBASE III or dBASE IV file.  The original BIBL database
  1681. is unchanged.  Type BIBL2DB to activate the program, then
  1682. give it the name of your BIBL format database, then the
  1683. name you want to give the resulting dBASE file.  Finally,
  1684. you must tell the program whether you want a dBASE III/III+
  1685. or dBASE IV format file created.
  1686.  
  1687. You can use the resulting dBASE file to perform operations
  1688. that BIBL does not support.
  1689.  
  1690. BIBL REGISTRATION [Release 8.49a ::10/06/93]
  1691.  
  1692.          Name:
  1693.  Company Name:
  1694.       Address:
  1695.          City:                     State:         Zip:
  1696.       Country:
  1697.  
  1698.  How (or where) did you obtain your copy of BIBL? _______________________
  1699.  Comments on the program:
  1700.  
  1701.  
  1702.  
  1703.  Are you currently a user of GMUtant OnLine BBS? Yes ___  No ___.  If not,
  1704.  when you first call, leave a comment to the Sysop. BBS#: 703-993-2219
  1705.  When you register, you will be sent the latest release by return 1st class
  1706.  mail. You'll also receive a registration number which will enable you to
  1707.  'upgrade' any subsequent SHAREWARE release to the REGISTERED version to
  1708.  unlock advanced features.
  1709.  
  1710.                            Registration Fees:
  1711.  
  1712.   Registration (w/ diskette & access to BBS)             $  39.00
  1713.   Site License (2-15  copies)                            $  29.25 each (-25%)
  1714.                (16-50 copies)                            $  19.50 each (-50%)
  1715.                (51+   copies)                            $  11.70 each (-70%)
  1716.   Novell (2.x or later) version (1-50 users)             $ 150.00 each
  1717.  
  1718.   Diskette: ___ 3.50"   ____ 5.25"       Total enclosed: $ __________
  1719.  
  1720.  !! Checks must be in US Dollars from a US account with an ABA routing !!
  1721.  !! number, made payable to:   Clyde W. Grotophorst                    !!
  1722.  
  1723.  Cash/Check or
  1724.  Site License:                         Credit Card Orders:
  1725.  
  1726.  Clyde W. Grotophorst                  Public Software Library
  1727.  Route 1, Box 296                      PO Box 35705, Houston, TX 77235-5705
  1728.  Hamilton, VA 22068 USA                1-800-242-4775  Fax: 1-713-524-6398
  1729.  BBS: (703) 993-2219                   Info: 1-713-524-6394
  1730.  
  1731.  You may also register BIBL via CompuServe (GO SWREG). If you go to
  1732.   the Shareware Registration forum, BIBL's Registration ID is 505
  1733.  
  1734.